home *** CD-ROM | disk | FTP | other *** search
/ Internet Tools (InfoMagic) / Internet Tools.iso / security / tcpr-1.2.README < prev    next >
Text File  |  1994-12-21  |  3KB  |  93 lines
  1. #
  2. # File:        README
  3. # Author:    G. Paul Ziemba <paul@alantec.com>
  4. # SCCS:        @(#)README    1.7 9/29/94
  5. # Purpose:    Describe the tcpr package
  6. #
  7. # Legal:    You may copy, modify, and distribute this software
  8. #        (the tcpr package) freely as long as this file
  9. #        is included in its entirety.
  10. #
  11. #        This software is provided free of charge, with no
  12. #        warranty of any kind, either expressed or implied.
  13. #        Use at your own risk.
  14. #
  15.  
  16. Contents of this file:
  17.     1. Introduction
  18.     2. Bug reports
  19.     3. Where to get it
  20.     4. Platforms
  21.     5. Acknowledgements
  22.  
  23. Introduction
  24. ------------
  25.  
  26.     Tcpr is a set of perl scripts that enable you to run ftp and telnet
  27. commands across a firewall. Forwarding takes place at the application
  28. level, so it's easy to control.
  29.  
  30.     Tcpr consists of an inetd-type server that interprets commands, 
  31. a relay program, and a client that talks to the server.
  32.  
  33.     The client asks the server for a relay connection to some specified
  34. remote host at a specified TCP port number; the server invokes the relay
  35. program and returns a proxy port number to the client. The client then
  36. invokes telnet or ftp, telling them to connect to the relay host at the
  37. proxy port number. The relay program then transfers data between the
  38. client host and the remote host.
  39.  
  40.     Special handling is implemented for the FTP data connection, so
  41. everything works properly.
  42.  
  43. Bug reports
  44. -----------
  45.  
  46.     Please email bug reports, comments, and patches to:
  47.     
  48.         tcpr-bugs@alantec.com.
  49.  
  50.  
  51. Where to get it
  52. ---------------
  53.  
  54.     Tcpr is available from the following servers via anonymous ftp:
  55.  
  56.     ftp.alantec.com        pub/tcpr
  57.     ftp.cs.umb.edu        pub/security
  58.     ftp.psg.com        pub/unix/netware
  59.     grasp1.univ-lyon1.fr    pub/unix/network/tcpip/security
  60.     ftp.denet.dk        pub/misc/tcpr
  61.  
  62.  
  63. Platforms
  64. ---------
  65.  
  66.     Tcpr is known to work on SunOS 4.1. I haven't tested it on other
  67. platforms, so I can't say if it'll work right out of the box for them.
  68. It's all perl, but the output format of the netstat and ifconfig commands
  69. might vary, and there isn't much flexibility in the parser for that yet.
  70.  
  71.  
  72.  
  73. Acknowledgements
  74. ----------------
  75.  
  76.     The tcpr package is based on a relay program written by
  77. Kazumasa Utashiro, <utashiro@sra.co.jp>. The relay program originally
  78. was to be invoked manually on the relay host, giving a port number which
  79. the user then used as an argument to the ftp or telnet program.
  80.  
  81.     I modified the relay program to select an outgoing interface
  82. based on some simple routing computations, and wrote a client and server
  83. to automate the process.
  84.  
  85.     Many thanks to the maintainers of the ftp sites mentioned above,
  86. listed in reverse alphabetical order (-:
  87.  
  88.     Christophe.Wolfhugel
  89.     John P. Rouillard
  90.     Kim H|glund
  91.     Randy Bush
  92.  
  93.